home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Franz PD / Franz PD Disk #279 (1993)(Rhein-Sieg-Soft).zip / Franz PD Disk #279 (1993)(Rhein-Sieg-Soft).adf / KILBM_V1.32.LHA / KILBM / KILBM_ENG.doc < prev    next >
Text File  |  1993-09-05  |  10KB  |  333 lines
  1.  
  2.                 KILBM V1.32
  3.  
  4.                - FREEWARE -
  5.  
  6.          (c) 1990-93 by Andreas R. Kleinert. All rights reserved.
  7.  
  8.           This program was written under OS V3.00 and is therefore
  9.           fully compatible. It needs OS >= V1.2.
  10.           This program needs 'ak_gen0.library' V37+ (in "LIBS:").
  11.  
  12.           Full AGA-Support because of flexible programming.
  13.  
  14.           Release Date : 05.09.1993
  15.  
  16.  
  17.     Copyright :
  18.     ===========
  19.  
  20.     The program KILBM and its documentation files are
  21.     (C)opyright 1990-93 by Andreas R. Kleinert. All rights reserved.
  22.  
  23.  
  24.     Disclaimer :
  25.     ============
  26.  
  27.     The author takes no responsibility for any results of the use of this
  28.     program.
  29.     This software is provided "AS IS" and there is no warranty of any kind,
  30.     so that you use this software at your own risk.
  31.  
  32.  
  33.     Distribution :
  34.     ==============
  35.  
  36.     The program KILBM V1.32 is freely distributable (FREEWARE).
  37.     You may copy it, if the copyright notice is left intact and
  38.     all of its parts are included in the distribution.
  39.     This program must not be included in commercial packages or commercial
  40.     program collections without my written permission.
  41.     This program must not be sold in any way, but it is allowed to take
  42.     a nominal fee including the costs for copying.
  43.  
  44.     This program may be put on public domain disks or included in public
  45.     domain disk libraries.
  46.     Special permission hereby goes to Fred Fish's AmigaLib-Disks and
  47.     the german series TAIFUN, FRANZ, TIME, GPD and Amiga Szene.
  48.  
  49.     This program may also be distributed via electronic mail and may be
  50.     put into mailboxes as long as the redistribution conditions are
  51.     respected in all points.
  52.  
  53.     By using or distributing this program you automatically agree to
  54.     all of the above conditions and terms.
  55.  
  56.  
  57.     Function :
  58.     ==========
  59.  
  60.     "KILBM" brings to you many possibilities to work with IFF-graphics :
  61.  
  62.      1) Showing of
  63.  
  64.        - packed and unpacked IFF-ILBM graphics
  65.        -        unpacked IFF-ACBM graphics
  66.  
  67.      2) Saving the screen as
  68.  
  69.        - packed or unpacked IFF-ILBM graphics.
  70.        -           unpacked IFF-ACBM graphics.
  71.  
  72.      3) Converting
  73.  
  74.        - IFF-ACBM graphics to IFF-ILBM graphics (packed/unpacked)
  75.        - IFF-ILBM graphics to IFF-ACBM graphics
  76.  
  77.  
  78.     The original file is not overwritten :
  79.     The destination file will be created with the extension ".ilbm"
  80.     or ".acbm" (depending on conversion mode).
  81.  
  82.     USE THIS OPTION CAREFULLY !!!
  83.  
  84.  
  85.     Additional Information :
  86.     ========================
  87.  
  88.     "KILBM" is the first in my small series of IFF-Reader und -Converter
  89.     programs.
  90.     Upto today there are also available :
  91.  
  92.     K8SVX     : For playing of IFF-8SVX-Samples.
  93.     KFTXT     : For reading and converting of IFF-FTXT-Files.
  94.     IFF-Arranger : Editing of IFF-Files (removing/adding of Chunks, ...)
  95.  
  96.  
  97.     Correspondence :
  98.     ================
  99.  
  100.     Wenn Sie wollen, können Sie mir etwas Geld senden. Sicherlich
  101.     wird mich das motivieren, weiterhin solche Programme zu schreiben
  102.     oder einfach Updates zu diesem zu erstellen.
  103.     Senden Sie bug-reports, Geld oder was-auch-immer an :
  104.  
  105.        Andreas R. Kleinert,
  106.        Grube Hohe Grethe 23,
  107.        D-57074 Siegen,
  108.        Germany.
  109.  
  110.  
  111.     Usage :
  112.     =======
  113.  
  114.     To get a help "how to use" KILBM V1.32, just type "KILBM ?" in the
  115.     CLI/Shell-Window.
  116.     Then you'll get a full explanation of all of its possibilities.
  117.  
  118.     Note :
  119.  
  120.     As far as I know, KILBM supports all EHB- (Extra-Half-Brite-) and
  121.     HAM- (Hold-And-Modify-) graphics without any problems.
  122.     This includes HAM6- as well as HAM8-graphics (AGA-Support).
  123.     But always be careful, if an IFF-picture does not contain a CAMG-Chunk.
  124.     If this is the case, KILBM tries to use the best available Screenmode
  125.     for the picture (HighRes/LowRes/HighRes-Lace/LowRes-Lace).
  126.     Look out for corresponding notes !
  127.  
  128.  
  129.     System-Info :
  130.     =============
  131.  
  132.     KILBM was programmed on an Amiga 4000 with 68030EC (25Mhz),
  133.     4 MB, 80 MB HD and OS 3.00 under SAS/C V6.03.
  134.  
  135.  
  136.     History :
  137.     =========
  138.  
  139.      V1.32 : (original-length KILBM       : 14140 Bytes,
  140.      -------  original-length KILBM_light :  7200 Bytes)
  141.  
  142.       - AUTOSCROLL-Flag under OS V2.04+ now set
  143.       - fixed bug in ScreenSave-Routine
  144.       - little improvements
  145.       - use of SAS/C V6.3
  146.  
  147.  
  148.      V1.31 : (original-length KILBM       : 14004 Bytes,
  149.      -------  original-length KILBM_light :  7068 Bytes)
  150.  
  151.       - added security check for bitplane buffer allocation at some places
  152.       - address changed slightly
  153.  
  154.  
  155.      V1.30 : (original-length KILBM       : 13772 Bytes,
  156.      -------  original-length KILBM_light :  7068 Bytes)
  157.  
  158.       - now with Color-Cycling Routine
  159.     NOT YET 100% PERFECT !!!
  160.       - and more improvements
  161.  
  162.  
  163.      V1.29 : (original-length KILBM       : 12492 Bytes,
  164.      -------  original-length KILBM_light :  5540 Bytes)
  165.  
  166.       - Control-Window was not closed, when bug occured in Display-Routine
  167.       - now can be used as a Default-Tool for Workbench-Projects
  168.       - now checks Mousebottons no longer directly, but opens a window
  169.     on the Display-Screen with IDCMP_MOUSEBUTTONS
  170.  
  171.  
  172.      V1.28 : (original-length KILBM       : 12172 Bytes,
  173.      -------  original-length KILBM_light :  5272 Bytes)
  174.  
  175.       - another "bytes per line"-fix (IFF-ILBM and -ACBM-Display)
  176.       - lowest accepted library version now is V37 of "ak_gen0.library"
  177.       - now FileRequester for Picture-Display, if no parameters or
  178.     Workbench-Start
  179.       - new program : KILBM_light, for viewing only IFF-ILBM-Files
  180.     (ACBM-, Write- and Convert-Options are missing)
  181.  
  182.  
  183.      V1.27 : (original size : 11972 Bytes)
  184.      -------
  185.  
  186.       - changed way of getting "bytes per line"
  187.     (because of possible bugs)
  188.       - now also able to save V39-Workbench-Screens with
  189.     interleaved BitMap (like IFF-ILBM).
  190.     ONLY Workbench-Screens yet (checks for Screen->Flags & WBENCHSCREEN).
  191.       - REMOVED read functions for replacement of the WB-Screen
  192.     by IFF-ILBM/IFF-ACBM.
  193.     This option was not very useful, but very incompatible.
  194.       - consequent use of _tinymain/_exit
  195.       - 09.04.1993 : removed "About_IFF.doc"
  196.  
  197.  
  198.      V1.26 : (original size : 13580 Bytes)
  199.      -------
  200.  
  201.       - code-splitting, use of SAS/C's new Optimizer (for speed)
  202.       - changed order of arguments in command line !!!
  203.       - now VERY FAST in displaying pictures
  204.       - saved space : about 1500 Bytes
  205.       - new : if no additional option is specified, the picture is
  206.     just displayed ...
  207.  
  208.  
  209.      V1.25 : (original size : 15100 Bytes)
  210.      -------
  211.  
  212.       - use of SAS/C V6.00
  213.       - use of "ak_gen0"-pragmas
  214.       - optimizations
  215.       - more integrated construction of read, show and conversion routines
  216.       - saved space : about 3000 Code-Bytes
  217.  
  218.  
  219.      V1.21 / V1.22 : (original size : 18084 Bytes)
  220.      ---------------
  221.  
  222.       - correct reading and writing of 32-Bit CAMGs.
  223.     This hopefully allows support of all new ECS and AA ScreenModes.
  224.       - routine for "mode guessing" if CAMG not available (or corrupt)
  225.       - different routines for "V33"- and "V37+"-ScreenOpening
  226.       - explicitely use of topaz-8 font for Display-Screen
  227.       - "big" pictures, where "BMHD.pageWidth"  > "BMHD.w"
  228.                or "BMHD.pageHeight" > "BMHD.h"
  229.     should now be displayed correctly
  230.       - removed very last rest of "byte-count" things
  231.  
  232.  
  233.      V1.19 :
  234.      -------
  235.  
  236.       - removed CRNG- and CCRT-Support (mostly useless)
  237.       - joined "About_IFF_xxxx.doc" to "About_IFF.doc"
  238.  
  239.  
  240.      V1.18 :
  241.      -------
  242.  
  243.       - removed "byte-count" things
  244.       - removed unnecessary parameters in functions
  245.  
  246.  
  247.      V1.17 :
  248.      -------
  249.  
  250.       - removed some unecessary code-bytes
  251.       - added additional doc-files
  252.  
  253.     - About_ILBM.doc    : Explains intention of IFF-ILBM-File-Format
  254.                   shortly.
  255.     - About_ACBM.doc    : Explains intention of IFF-ACBM-File-Format
  256.                   shortly.
  257.  
  258.       - added additional warnings about careful use to this doc-file ...
  259.       - added "Additional Information" paragraph
  260.  
  261.  
  262.      V1.16 :
  263.      -------
  264.  
  265.       - use of pragmas (register parameters for system calls)
  266.       - rewrote parts of "printf()"-routine
  267.       - doc-fix :
  268.  
  269.      I forgot to mention at the top, that with V1.15
  270.      "ak_gen0.library" V35+ is needed.
  271.      (Error text already had been updated.)
  272.      This is because of prevention of bugs.
  273.  
  274.  
  275.      V1.15 :
  276.      -------
  277.  
  278.       - Lowest accepted library version now is V35 of "ak_gen0.library"
  279.       - won about 3700 Bytes because of own "printf()"-routine
  280.       - splitted some strings to save space
  281.       - reduced and corrected error strings and codes, also to save
  282.     space (and to prevent bugs/misunderstandings)
  283.       - a future support of things like "locale.library" would now
  284.     be much easier (I hope)
  285.       - fixed a bug, which occured, when displaying packed/unpacked
  286.     IFF-ILBM or IFF-ACBM-Brushes (only ODD-LINED Brushes)
  287.       - fixed same bug in conversion-routines (-ci/-cim/-ca)
  288.       - safety check for screen opening has been added
  289.     (now code becomes more and more longer, but even shorter than before !)
  290.       - could not use global optimizer (GO), because with it there
  291.     occured some silly bugs (don't know which reason),
  292.     so we need some more code-bytes
  293.       - converted files now get the extension ".ilbm" (for -ci/-cip)
  294.     or ".acbm" (for -ca)
  295.  
  296.  
  297.      V1.12 :
  298.      -------
  299.  
  300.       - Hopefully fixed a bug, that would have caused problems, when saving
  301.     Screens other than 640x256.
  302.     Note : Overscan limit is (as far as I know) 704x283 or 736x290.
  303.            KILBM also manages things like 724x283 (x + 20), but other
  304.            programs might not accept this.
  305.       - Well it also seems, that now brushes are displayed correctly.
  306.     (Tested with ENV:sys/pointer.ilbm (Brush) of the WB V2.04.
  307.      Showing of ENV:sys/palette.ilbm (Brush f. Colors) also didn't cause
  308.      any problems.)
  309.       - "doc-fixes"
  310.       - translated some german output-texts into english (and "sorted" them
  311.     new)
  312.  
  313.  
  314.      V1.11 :
  315.      -------
  316.  
  317.       - First official released FREEWARE version.
  318.  
  319.  
  320.      V1.00 - V1.10 :
  321.      ---------------
  322.  
  323.       - Private work versions. Not released.
  324.  
  325.  
  326.     Copyrights :
  327.     ============
  328.  
  329.     Some of the mentioned names or products above may be copyrighted by
  330.     companies or trademarks of companies.
  331.  
  332.  
  333.